Note

Description

This PR adds integration tests for media file handling in the dev command, covering both public and private file upload/serve flows. It also refactors the waitForDevServer helper into a shared dev-utils.ts testkit utility so it can be reused across test files.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe): Test coverage addition with minor testkit refactoring

Changes Made

• Added packages/cli/tests/cli/dev-media.spec.ts with two new integration tests:
  • Public file upload: uploads a file via Core/UploadFile, verifies the returned URL, and fetches the file content
  • Private file upload: uploads a file via Core/UploadPrivateFile, obtains a signed URL via Core/CreateFileSignedUrl, and validates access with valid token, wrong token (400 + InvalidJWT), and missing token (401 + Missing token)
• Extracted waitForDevServer from dev.spec.ts into packages/cli/tests/cli/testkit/dev-utils.ts to share it across test files
• Updated dev.spec.ts to import waitForDevServer from the new shared location

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (npm test)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated docs/ (AGENTS.md) if I made architectural changes

Additional Notes

The waitForDevServer refactor also improves robustness by throwing an explicit error if the URL pattern is not found (instead of a non-null assertion).

_{🤖 Generated by Claude | 2026-03-23 13:22 UTC}